PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager


CreateWindowFromCollection

Creates a window from collection data.

pascal OSStatus CreateWindowFromCollection (
                     Collection collection,
                     WindowPtr *outWindow);
collection
A reference to the collection to be used in creating the window. You pass a reference to a previously created collection, such as that returned by the Collection Manager function NewCollection . The collection used to create the window must contain the required items for a resource of type 'wind' or window creation fails.
outWindow
A pointer to a value of type WindowPtr . On return, the window pointer points to the newly created window.
function result
A result code. See Result Codes.
DISCUSSION

The CreateWindowFromCollection function creates a window invisibly and places it at the front of the window list. After calling CreateWindowFromCollection , you should set any desired associated data--using Window Manager or Control Manager accessor functions--then call the function TransitionWindow to display the window. The number of references to the collection (that is, its owner count) is incremented by a minimum of one for the duration of this call.

VERSION NOTES

Available with Mac OS 8.5 and later.

SEE ALSO

The chapter "Collection Manager" in Inside Macintosh: QuickDraw GX Environment and Utilities .


© 1999 Apple Computer, Inc. – (Last Updated 18 March 99)